home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / dev / misc / FlexCat.readme < prev    next >
Encoding:
Text File  |  1997-09-05  |  10.1 KB  |  199 lines
  1. Short:    1.9 - Flexible catalogs (C, Asm, Oberon, E, ...)
  2. Author:   Marcin Orlowski <carlos@inet.com.pl>
  3. Uploader: Marcin Orlowski <carlos@inet.com.pl>
  4. Version:  1.9
  5. Type:     dev/misc
  6. Replace:  dev/misc/FlexCat*
  7. Www:      http://wfmh.man.szczecin.pl/flexcat/
  8.  
  9.  
  10.   INFO
  11.   ----------
  12.  
  13.     FlexCat creates catalogs and the source to handle them.  The difference
  14.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  15.   designed to produce any source you want:  any programming language, any
  16.   individual needs should be satisfied.  However, FlexCat is not more
  17.   difficult to use.
  18.  
  19.     This sounds like a contradiction.  FlexCat's solution is to use
  20.   template files, the so called "source descriptions".  Ready to use examples
  21.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  22.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  23.   are welcome.
  24.  
  25.  
  26.   Changes since previous release:
  27.   -------------------------------
  28.  
  29.   * V1.9 (01.08.97) - Now you can use special $TODAY attribute
  30.                       in your $VER string. While creating catalog,
  31.                       $TODAY will be replaced by current date (note,
  32.                       only 1st occurance will be processed). If you
  33.                       want your version strings to always be recent
  34.                       dated type: $VER: FlexCat.catalog 3.0 ($TODAY)
  35.                       NOTE: This string is CASESENSITIVE!
  36.  
  37.                       FlexCat preferences added. To define your own
  38.                       defaults, set the environmental variable
  39.                       "flexcat.prefs" with the contents matching
  40.                       following template: "SDDIR/K,MSG_NEW/K,
  41.                       WARNCTGAPS/S,NOOPTIM/S,FILL/S,FLUSH/S,NOBEEP/S,
  42.                       QUIET/S". Note FlexCat is using ReadArgs()
  43.                       to parse the preferences, thus place all the
  44.                       items in one line.
  45.  
  46.                       If you use FlexCat for #?.ct updating, you
  47.                       probably was missing any additional markers
  48.                       to let you easily find the new strings. Now
  49.                       you get them. By default the "***NEW***", 
  50.                       is used, but you may configure it using
  51.                       FlexCat preferences.
  52.  
  53.                       QUIET switch used to suppress error messages.
  54.                       Fixed.
  55.  
  56.                       New C source descriptor Cat2h_?.sd. Read
  57.                       the manual or Lib/Cat2h.readme for more
  58.                       information.
  59.  
  60.                       Version of updated catalogs bumped to 2.5
  61.  
  62.                       Portugese translation of program catalog, thanks
  63.                       to Frederico Borges <famb@mail.telepac.pt> and
  64.                       Alexandre Gabriel <chryse@mail.telepac.pt>
  65.  
  66.                       Swedish translation of FlexCat manual,
  67.                       thanks to Magnus Holmgren <cmh@lls.se>
  68.  
  69.                       Spanish translation reworked by
  70.                       Marcos Broc <amiga187@arrakis.es> and 
  71.                       Samuel Aguilera <slyguy92@arrakis.es>
  72.  
  73.                       Now FlexCat does DisplayBeep() when any error
  74.                       or warning happen (but don't worry, it's smart
  75.                       enough, so you won't experience any Beep() bombing ;).
  76.                       By using NOBEEP switch you can shut it up.
  77.  
  78.                       Previous releases had problems with comment lines
  79.                       ending with \'s, which made FlexCat think it's multiline
  80.                       string. Now it is not as dumb to get fooled any longer.
  81.  
  82.                       You can now use octal, decimal and hexadecimal
  83.                       (e.g 0x20) digits for all FlexCat digital arguments
  84.                       (like ##version) as well as for (ID/MIN/MAX),
  85.                       ##codeset and others.
  86.  
  87.                       FLUSH switch added. By using it all unused
  88.                       catalogs (but also libraries, fonts, devices etc) will
  89.                       be flushed from memory, whenever new catalog is
  90.                       written. So note: FLUSH works only with CATALOG switch
  91.                       (it means while compiling new catalog).
  92.  
  93.                       New C source descriptors: catcomp_h.sd creates
  94.                       source (almost) identical to CatComp's ones, but
  95.                       expanded for multicatalog support. With this
  96.                       descriptor you can handle more than one catalog
  97.                       in your program harmless.  NOTE:  for compatibility
  98.                       reasons, other descriptors remain unchanged (however
  99.                       additional, multicatalog versions may appear
  100.                       in next release).
  101.  
  102.                       FlexCat does not accept empty ##language argument
  103.                       any longer.
  104.  
  105.                       FILL switch. This feature is highly useful for the
  106.                       translators, and probably for them only. Normally,
  107.                       when you're working on the new translation, some
  108.                       of the strings remains untranslated due the work
  109.                       is just in progress. Unfortunately all catalog
  110.                       tools write all these empty strings into the catalog
  111.                       file, which will cause empty buttons, menus or simmilar
  112.                       things to appear whenever you check your unfinished
  113.                       translation with the program, which isn't nice effect.
  114.                       Using FILL you may force FlexCat to ignore all empty
  115.                       translations (strings from #?.ct file) and instead
  116.                       to write original string (from #?.cd) to the catalog.
  117.                       That prevents you from watching empty GUI etc.
  118.                       NOTE: this option is only for testing purposes.
  119.                       Final catalogs should always be created without FILL
  120.                       swich used!
  121.  
  122.                       English manual is now up-to-date.
  123.  
  124.                       Added %a, %t and %z operands for source
  125.                       descriptors. See (probably english and
  126.                       swedish only, for now) manual for detailed
  127.                       information
  128.  
  129.  
  130. ============================= Archive contents =============================
  131.  
  132. Original  Packed Ratio    Date     Time    Name
  133. -------- ------- ----- --------- --------  -------------
  134.      669     322 51.8% 07-Aug-97 14:54:32  FlexCat.info
  135.      632     289 54.2% 07-Aug-97 14:54:32 +AmigaGuide.info
  136.    53069   17395 67.2% 01-Aug-97 00:00:00 +FlexCat_deutsch.guide
  137.      464     241 48.0% 07-Aug-97 14:53:18 +FlexCat_deutsch.guide.info
  138.    59830   19293 67.7% 01-Aug-97 00:00:00 +FlexCat_english.guide
  139.      464     242 47.8% 07-Aug-97 14:53:18 +FlexCat_english.guide.info
  140.    42792   13750 67.8% 01-Aug-97 00:00:00 +FlexCat_español.guide
  141.      464     240 48.2% 07-Aug-97 14:53:18 +FlexCat_español.guide.info
  142.    60447   19818 67.2% 01-Aug-97 00:00:00 +FlexCat_svenska.guide
  143.      464     244 47.4% 07-Aug-97 14:53:18 +FlexCat_svenska.guide.info
  144.     2628    1139 56.6% 01-Aug-97 00:00:00 +FlexCat.catalog
  145.     2734    1152 57.8% 01-Aug-97 00:00:00 +FlexCat.catalog
  146.     2598    1149 55.7% 01-Aug-97 00:00:00 +FlexCat.catalog
  147.     5983    1836 69.3% 01-Aug-97 00:00:00 +FlexCat.cd
  148.     2894    1181 59.1% 01-Aug-97 00:00:00 +FlexCat.catalog
  149.     2830    1284 54.6% 01-Aug-97 00:00:00 +Flexcat.catalog
  150.     3006    1399 53.4% 01-Aug-97 00:00:00 +FlexCat.catalog
  151.     3546    1429 59.7% 01-Aug-97 00:00:00 +FlexCat.catalog
  152.     2400    1169 51.2% 01-Aug-97 00:00:00 +FlexCat.catalog
  153.     2908    1296 55.4% 01-Aug-97 00:00:00 +FlexCat.catalog
  154.     3024    1373 54.5% 01-Aug-97 00:00:00 +FlexCat.catalog
  155.     3342    1455 56.4% 01-Aug-97 00:00:00 +FlexCat.catalog
  156.     3048    1463 52.0% 01-Aug-97 00:00:00 +FlexCat.catalog
  157.    33052   18857 42.9% 01-Aug-97 00:00:00 +FlexCat
  158.    10292    3518 65.8% 07-Aug-97 14:59:06 +FlexCat.history
  159.      840     327 61.0% 07-Aug-97 14:54:32 +FlexCat.history.info
  160.     6319    2449 61.2% 07-Aug-97 14:59:02 +FlexCat.readme
  161.      840     326 61.1% 07-Aug-97 14:54:32 +FlexCat.readme.info
  162.     1886     838 55.5% 01-Aug-97 00:00:00 +AmigaOberon.sd
  163.     2746    1123 59.1% 01-Aug-97 00:00:00 +AutoC_c.sd
  164.      511     258 49.5% 01-Aug-97 00:00:00 +AutoC_h.sd
  165.     2247     824 63.3% 01-Aug-97 00:00:00 +AztecAs_asm.sd
  166.      383     180 53.0% 01-Aug-97 00:00:00 +AztecAs_i.sd
  167.     3272    1267 61.2% 01-Aug-97 00:00:00 +C++_CatalogF.cc
  168.     1319     671 49.1% 01-Aug-97 00:00:00 +C++_CatalogF.h
  169.      506     242 52.1% 01-Aug-97 00:00:00 +C++_cc.sd
  170.      739     376 49.1% 01-Aug-97 00:00:00 +C++_h.sd
  171.     5422    1916 64.6% 01-Aug-97 00:00:00 +C_c.sd
  172.     5300    1856 64.9% 01-Aug-97 00:00:00 +C_c_V20.sd
  173.     1624     689 57.5% 01-Aug-97 00:00:00 +C_c_V21.sd
  174.      733     365 50.2% 01-Aug-97 00:00:00 +C_h.sd
  175.     1511     796 47.3% 01-Aug-97 00:00:00 +Cat2h.readme
  176.     1573     735 53.2% 01-Aug-97 00:00:00 +Cat2h_c.sd
  177.      367     187 49.0% 01-Aug-97 00:00:00 +Cat2h_h.sd
  178.     2363     747 68.3% 01-Aug-97 00:00:00 +CatComp_h.sd
  179.     1501     628 58.1% 01-Aug-97 00:00:00 +E21b.sd
  180.     1953     750 61.5% 01-Aug-97 00:00:00 +E30b.sd
  181.      483     272 43.6% 01-Aug-97 00:00:00 +Modula2Def.sd
  182.     2118     827 60.9% 01-Aug-97 00:00:00 +Modula2Mod.sd
  183.     2074     878 57.6% 01-Aug-97 00:00:00 +Oberon-A.sd
  184.     1684     747 55.6% 01-Aug-97 00:00:00 +Oberon_V38.sd
  185.     1683     743 55.8% 01-Aug-97 00:00:00 +Oberon_V39.sd
  186.     2293     840 63.3% 01-Aug-97 00:00:00 +SASasm_a.sd
  187.      370     175 52.7% 01-Aug-97 00:00:00 +SASasm_i.sd
  188.      632     288 54.4% 07-Aug-97 14:54:32 +TexInfo.info
  189.    47904   17344 63.7% 10-Feb-97 00:00:00 +FlexCat_deutsch.texinfo
  190.      919     452 50.8% 07-Aug-97 14:53:08 +FlexCat_english.deutsch.info
  191.      919     453 50.7% 07-Aug-97 14:53:08 +FlexCat_english.svenska.info
  192.    52843   18737 64.5% 07-Aug-97 14:39:12 +FlexCat_english.texinfo
  193.      919     449 51.1% 07-Aug-97 14:53:08 +FlexCat_english.texinfo.info
  194.    38914   13905 64.2% 10-Feb-97 00:00:00 +FlexCat_español.texinfo
  195.      919     453 50.7% 07-Aug-97 14:53:08 +FlexCat_español.texinfo.info
  196.    53911   19333 64.1% 25-May-97 22:47:24 +FlexCat_svenska.texinfo
  197. -------- ------- ----- --------- --------
  198.   556120  204980 63.1% 08-Aug-97 08:26:00   63 files
  199.